home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d12 / csr_001.arc / README.DAT < prev    next >
Text File  |  1988-09-02  |  8KB  |  167 lines
  1.  
  2.  
  3.                                C Spot Run
  4.  
  5.                     A User-Supported C Add-On Library
  6.  
  7.                        Version 3.0  "ReadMe" File
  8.  
  9.                               July 12, 1988
  10.  
  11.  
  12.         Hello and welcome to the C Spot Run package.  I'm your  host,
  13.     the  infamous README file.... This file serves several  purposes:
  14.     it allows me to fill you in on the latest information that didn't
  15.     make it into the documentation; it helps you to get started  with
  16.     this  package; it lets me show off some CSR features through  the
  17.     README.C  program, and it is less formal than the  documentation.
  18.     So  let's get started....  (NOTE: To print this file  type  "COPY
  19.     README.DAT PRN" at the DOS prompt.)
  20.  
  21.         Following is a list of the files in this archive and a  short
  22.     description of each.
  23.  
  24.         CCDEMOMS.BAT     Batch to compile CSRDEMO for Microsoft.
  25.         CCDEMOTC.BAT     Batch to compile CSRDEMO for Turbo C.
  26.         CHECKC.EXE       Executable for the CheckC program.
  27.         COLOR.H          Include file with color definitions.
  28.         CSPOTRUN.DOC     Complete C Spot Run documentation.
  29.         CSR.H            New standard header file for C Spot Run.
  30.         CSRDEMO.C        Demo program for C Spot Run.
  31.         CSRDEMO.EXE      Executable of CSRDEMO.C.
  32.         CSRDEMO.PRJ      Project file to make CSRDEMO in Turbo C.
  33.         CSRDEMO.MAK      Make file to compile CSRDEMO in QuickC.
  34.         CSRDOS.H         Include file for directory searching.
  35.         CSRMENU.H        Include file for menu routines.
  36.         CSRMISC.H        Assorted #definitions for CSR.
  37.         CSRMODES.H       Include file with set_mode() options.
  38.         CSRORDER.C       Source to CSR online order form program.
  39.         CSRORDER.EXE     Executable of online order form program.
  40.         CSRQCS.LIB       Linkable  version  of  the  library  for
  41.                          Microsoft C v5.x and QuickC.  (Small)
  42.         CSRQCM.LIB       Linkable  version  of  the  library  for
  43.                          Microsoft C v5.x and QuickC.  (Medium)
  44.         CSRSHELL.ASM     Shell for assembly interface to C.
  45.         CSRSOUND.H       Some note values and declarations.
  46.         CSRTIME.H        Text arrays for week and names.
  47.         ERRORS.H         Text of critical DOS errors.
  48.         FLINE.EXE        Executable for the FirstLine program.
  49.         README.C         The source code to the README program.
  50.         README.DAT       The file you are reading now.
  51.         README.EXE       The executable version of README.
  52.         SKEY.H           Special extended key definitions.
  53.         TIMERS.C         Source code to timer functions.
  54.         TCSCSR.LIB       Linkable  version  of  the  library  for
  55.                          Turbo C v1.5.  (Small)
  56.  
  57.  
  58.     What's Up
  59.  
  60.         So  much  has happened since Version 2.1  was  released  last
  61.     August  that  I don't know where to begin.  I  suppose  the  best
  62.     place would be with the apology, and that's for the fact that  it
  63.     has  been  almost a year since the last release.   I  can  easily
  64.     understand  the agonizing frustration of users who moved  to  the
  65.     new Microsoft and Borland compilers only to find that CSR  hadn't
  66.     moved with them. It has been a long road for me but I can finally
  67.     announce  with  great pleasure that CSR is now working  with  the
  68.     latest  compiler  versions in all of their  incarnations.   I  am
  69.     forever  grateful  for  the  technical  and  moral  support  I've
  70.     received  from users who have been more than patient  during  the
  71.     transition.
  72.  
  73.  
  74.     The NDS News
  75.  
  76.         The C Spot Run Support Newsletter has changed immensely.  Now
  77.     reborn  as  The  NDS  News it  hosts  numerous  useful  articles,
  78.     complete  with  source code examples, and  sports  an  attractive
  79.     desktop-published design. It is now available in hard-copy  only,
  80.     so  if  you haven't received a copy yet you'll want  to  get  one
  81.     right away.
  82.  
  83.         How do you get a copy?  Glad you asked. <smile>  You need  to
  84.     get  on the mailing list, and you can do that by sending  in  the
  85.     form generated by CSRORDER, or, better yet, by registering as a C
  86.     Spot Run User. For the time being I'm sending a copy to  everyone
  87.     on  the mailing list. However the postage and printing costs  are
  88.     rising  constantly and I won't be able to keep this up.  All  you
  89.     need to do to assure continued newsletter subscription and update
  90.     notification is to register for CSR at any level.
  91.  
  92.  
  93.     Getting Started
  94.  
  95.         The   first   step  to  using  CSR  is  to  print   out   the
  96.     documentation.   It's  250 pages long, so check  your  paper  and
  97.     ribbon.  Make sure you're using a monospaced font if you're using
  98.     a laser printer, and then type "Copy CSpotRun.DOC PRN" at the DOS
  99.     prompt.   Unlike  previous versions this  documentation  includes
  100.     form feeds, so alignment isn't a problem.  (The first page can go
  101.     several lines off either way.)
  102.  
  103.         If  you're  new  to CSR you'll want to  read  the  first  few
  104.     sections of the documentation in order to get started,  otherwise
  105.     you're  all set, except for running the CSRORDER  program,  which
  106.     you'll  want  to  do right away to REGISTER  and/or  get  on  the
  107.     mailing list....
  108.  
  109.  
  110.     Registration: How and Why
  111.  
  112.         If  you use C Spot Run it's important to register as a  user.
  113.     Not  only  do  you receive the benefits of  source  code,  update
  114.     notifications,  the  NDS News, etc., but you get a  warm  feeling
  115.     from  helping  to  support the Shareware  effort.   Without  your
  116.     support  I can't afford to go on supporting CSR, as much  as  I'd
  117.     like to.
  118.  
  119.         I  want to make registration as easy as possible for you,  so
  120.     there are a number of options.  First, with the NDS News comes  a
  121.     printed  order  form with complete instructions on a  nice,  good
  122.     looking form.  Secondly, the CSRORDER program included with  this
  123.     package  will  prompt you for all of  the  important  information
  124.     online  and  printout a one page form for registering  or  simply
  125.     getting on the mailing list.  Your third option is to send in the
  126.     order form at the end of the CSR documentation.  And last but not
  127.     least,  you can register with a credit card on-line and  download
  128.     the source code right away!
  129.  
  130.         This  last option needs the most explanation, so here it  is:
  131.     The Shareware BBS in San Diego, CA, at (619) 455-5226, 2400 baud,
  132.     allows you to register on-line with a Visa or Mastercard and then
  133.     download the source code immediately.  (After registering on-line
  134.     you should send in one of the printed forms with PAID written  on
  135.     it  to  assure  that an "official" disk is mailed  and  a  serial
  136.     number assigned.)
  137.  
  138.  
  139.     Final Comments
  140.  
  141.         In the confusion of putting this release together some things
  142.     may  have  slipped  by me.  I've tried to test  CSR  in  all  the
  143.     distributed  configurations  and I'm confident that  the  package
  144.     performs as documented.  The library has undergone months of  use
  145.     with  QuickC  /  MSC  5.x, and I've tested  it  a  lot  with  the
  146.     integrated environments and command line version of Turbo C v1.5.
  147.     If  you do find a problem, though, please let me know right  away
  148.     so  I  can try and fix it.  The problems with Turbo C  v1.0  this
  149.     past year practically crippled the product, and I don't want that
  150.     to happen again.
  151.  
  152.         If all goes well a v3.1 of CSR should follow in the next  few
  153.     months  to handle any bugs that crop up and expand  the  function
  154.     library.  Vaporware, I know, but I'm honestly trying.
  155.  
  156.         Finally,  in  the  v2.1  README  file  I  asked  for  letters
  157.     supporting my college applications.  I want to thank those of you
  158.     who  took the time to write something about myself and  CSR,  and
  159.     I'm  happy  to  announce  that  I've  been  accepted  at   Drexel
  160.     University as a Computer Science student this fall.
  161.  
  162.         Thanks for your support, and good luck with CSR.  Please feel
  163.     free to call me with any questions, comments, or suggestions.
  164.  
  165.         - Bob Pritchett  (609) 424-2595 (Voice)
  166.  
  167.